Socket
Socket
Sign inDemoInstall

@thi.ng/logger

Package Overview
Dependencies
0
Maintainers
1
Versions
72
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    @thi.ng/logger

Types & basis infrastructure for arbitrary logging (w/ default impls)


Version published
Weekly downloads
1.1K
decreased by-13.42%
Maintainers
1
Created
Weekly downloads
 

Readme

Source

[!IMPORTANT] ‼️ Announcing the thi.ng user survey 2024 📋

Please participate in the survey here!
(open until end of February)

To achieve a better sample size, I'd highly appreciate if you could circulate the link to this survey in your own networks.

Discussion

@thi.ng/logger

npm version npm downloads Mastodon Follow

[!NOTE] This is one of 189 standalone projects, maintained as part of the @thi.ng/umbrella monorepo and anti-framework.

🚀 Help me to work full-time on these projects by sponsoring me on GitHub. Thank you! ❤️

About

Types & basis infrastructure for arbitrary logging (w/ default impls).

The types & implementations provided by this package are used in various places throughout the thi.ng/umbrella ecosystem and can be swapped out on demand to customize users' needs.

Log levels

All loggers based on this basic framework provided by this package support the following LogLevels (in order of importance):

  • FINE
  • DEBUG
  • INFO
  • WARN
  • SEVERE

Logging calls targetting lower levels than configured in the logger will be ignored.

Supplied implementations

The following logger implementations are provided:

Lazy evaluation

Log messages can contain any number & types of arguments. No-arg functions can be provided as message arg to avoid evaluation of potentially costly message formatting for suppressed log levels. For example:

import { ConsoleLogger, LogLevel } from "@thi.ng/logger";

const logger = new ConsoleLogger("app", LogLevel.INFO);

const name = "thi.ng";

// eager (standard) arg evaluation
logger.info(`hello, ${name}`);
// [INFO] app: hello, thi.ng

// eager (standard) arg evaluation, but suppressed output
logger.debug("result is", 23 + 42);

// lazy arg evaluation
logger.info("result is", () => 23 + 42);
// [INFO] app: result is 65

Status

STABLE - used in production

Search or submit any issues for this package

Installation

yarn add @thi.ng/logger

ES module import:

<script type="module" src="https://cdn.skypack.dev/@thi.ng/logger"></script>

Skypack documentation

For Node.js REPL:

const logger = await import("@thi.ng/logger");

Package sizes (brotli'd, pre-treeshake): ESM: 695 bytes

Dependencies

None

Usage examples

One project in this repo's /examples directory is using this package:

ScreenshotDescriptionLive demoSource
Declarative component-based system with central rstream-based pubsub event busDemoSource

API

Generated API docs

TODO

Authors

If this project contributes to an academic publication, please cite it as:

@misc{thing-logger,
  title = "@thi.ng/logger",
  author = "Karsten Schmidt",
  note = "https://thi.ng/logger",
  year = 2016
}

License

© 2016 - 2024 Karsten Schmidt // Apache License 2.0

Keywords

FAQs

Last updated on 10 Feb 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc